home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 6: Level 6 / 17 Bit - Level 6 (1998)(Epic Marketing)[!].iso / quartz / q0038.dms / q0038.adf / Tech_Ref < prev    next >
Text File  |  1991-04-07  |  41KB  |  1,123 lines
  1.                            TABLE OF CONTENTS
  2.  
  3.  
  4.           
  5.  
  6.           1  TECHNICAL SPECIFICATIONS       ....................  1-1
  7.              1.1  L:MSDOSFileSystem        .....................  1-1
  8.              1.2  DEVS:mfm.device        .......................  1-1
  9.  
  10.           2  MountList Example of an MS-DOS device   ...........  2-1
  11.  
  12.           3  GLOSSARY        ...................................  3-1
  13.  
  14.           4  DEVICE ERROR CODES      ...........................  4-1
  15.              4.1  "In Case of Difficulty"     ..................  4-1
  16.                 4.1.1  Problem/Solution Chart       ............  4-1
  17.                 4.1.2  Helpful Tips       ......................  4-3
  18.  
  19.           5  CrossDOS UTILITIES       ..........................  5-1
  20.              5.1  MS-DOS File System Support Utilities    ......  5-1
  21.              5.2  "MountMF"        .............................  5-1
  22.                 5.2.1  "Mount_JDS"        ......................  5-1
  23.                 5.2.2  "Kill"        ...........................  5-2
  24.                 5.2.3  "DiskChk"        ........................  5-3
  25.                 5.2.4  "MFormat"        ........................  5-3
  26.                 5.2.5  "MDiskCopy"        ......................  5-5
  27.                 5.2.6  "Attach"        .........................  5-6
  28.                 5.2.7  "TxFilter"        .......................  5-6
  29.                 5.2.8  "IntlTrans"        ......................  5-7
  30.                 5.2.9  "DiskChg"        ........................  5-8
  31.                 5.2.10  "TDPatch12 or TDPatch13"      ..........  5-8
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                                                      I
  60.                                    CrossDOS ... The MS-DOS File System
  61.  
  62.  
  63.           w1    TECHNICAL SPECIFICATIONS       w 
  64.  
  65.           The  following  are the technical specifications of the file
  66.           system and device driver.  
  67.  
  68.           1.1  L:MSDOSFileSystem         
  69.  
  70.           The  Amiga  allows  for  foreign disk formats as well as the
  71.           standard  AmigaDOS  disk  format  to  be  used  by placing a
  72.           common  interface  (DOS  interface)  between the application
  73.           and  the  file system.  The file system code that translates
  74.           the  foreign  disk format must conform to at least a minimum
  75.           set of commands from this DOS interface.  
  76.  
  77.           The  MS-DOS  File  System  code  translates the DOS commands
  78.           into  MS-DOS  disk  format  specific reads and writes to the
  79.           device.   If the device is a floppy disk, the file system is
  80.           initialized  to  open the "mfm.device" to translate raw data
  81.           from  the  disk  into  data  blocks  and  vice versa.  Other
  82.           devices  could  be  used  by  using  the  device driver code
  83.           supplied by the device controller manufacturer.  
  84.  
  85.  
  86.           1.2  DEVS:mfm.device         
  87.  
  88.           The  "mfm.device" is used to decode and encode "mfm" data in
  89.           a  standard  (non-Amiga)  format  on a floppy disk.  It acts
  90.           very  much like the Amiga-supplied "trackdisk.device" device
  91.           driver  code.   It  answers  requests  for drive control and
  92.           blocks of data transfer.  
  93.  
  94.           The  "mfm.device"  responds to all the command types as does
  95.           the "trackdisk.device" with the following exceptions: 
  96.  
  97.             -  EXT (Extended) command qualifiers are not valid.  
  98.  
  99.             -  A  new command MDCMD_SETPARMS = 29 is included to allow
  100.                the  device  driver  to  set  some of the physical disk
  101.                parameters   to   new  values.   The  FileSysStartupMsg
  102.                Environment  Table  pointer is passed in io_Data.
  103.                Any errors are returned in io_Error.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                                                    1-1
  119.                                    CrossDOS ... The MS-DOS File System
  120.  
  121.  
  122.           w2    MountList Example of an MS-DOS device   w 
  123.  
  124.           The  following  is  an example mountlist entry for an MS-DOS
  125.           device  using the internal 3 1/2" drive in the Amiga.  It is
  126.           called  by  the  name DI0: by the system.  Other units
  127.           and  device  names can be used as specified by Amiga "mount"
  128.           command file parameters.  
  129.  
  130.                DI0:
  131.                        /* Device-dependent mountlist parameters */
  132.                    Device = mfm.device
  133.                    Unit   = 0
  134.                    Flags  = 1
  135.                    Surfaces  = 2
  136.                    BlocksPerTrack = 9
  137.                    Reserved = 1
  138.                    Interleave = 0
  139.                    LowCyl = 0  ;  HighCyl = 79
  140.  
  141.                        /* FileSystem-dependent mountlist parameters */
  142.                    FileSystem = L:MSDOSFileSystem
  143.                    Stacksize = 4000
  144.                    Priority = 5
  145.                    GlobVec = -1
  146.                    Buffers = 5
  147.                    BufMemType = 0 
  148.                    Mount = 0
  149.                    DosType = 0x4D534400
  150.                         /* = 0x4D444400  using Double Track Step Mode */
  151.                #
  152.  
  153.  
  154.           NAME: 
  155.              The   name   of   the   device.   It  may  be  any  valid
  156.              alphanumeric  combination  that  does  not  conflict with
  157.              other  device,  volume  or logical names already mounted.
  158.              The  name  must  end  in  a  ":"  to be recognized by the
  159.              "mount" command.  
  160.  
  161.           Device =
  162.              The  name  of  the device driver code file to be used for
  163.              the  particular  device  being  accessed.   When  using a
  164.              floppy  drive  device,  the device driver "mfm.device" is
  165.              included  in this product for this purpose.  Please note:
  166.              the directory "DEVS:" is assumed as the path name.  
  167.  
  168.           Unit = 
  169.              The  physical  unit number of the particular device being
  170.              accessed.   Normally,  Unit  0  is  the  first unit.  For
  171.              Amiga floppy drives, Unit 0 is the internal drive.  
  172.  
  173.           Flags = 
  174.  
  175.  
  176.  
  177.                                                                    2-1
  178.           CrossDOS ... The MS-DOS File System
  179.  
  180.  
  181.              The  flags  needed  to  properly initialize the device at
  182.              startup.   The  flags  to  be  set  will  vary  for  each
  183.              device.   For  the  Amiga  compatible  floppy drives, set
  184.              Flags to '1' (allow 5 1/4" drive).
  185.  
  186.           Surfaces = 
  187.              The  number  of  physical  surfaces  of  the device.  For
  188.              standard  MS-DOS  floppies,  set  this  value  to  2  for
  189.              double-sided.  
  190.  
  191.           BlocksPerTrack = 
  192.              The  number  of  physical  blocks  on  each  track of the
  193.              device.   For standard MS-DOS floppies, set this value to
  194.              9.  
  195.  
  196.           Reserved =
  197.              The  number  of  reserved blocks for the beginning of the
  198.              partition  of  the device.  For standard MS-DOS floppies,
  199.              set this value to 1.  
  200.  
  201.           Interleave = 
  202.              The  physical  interleave  of sectors of the device.  For
  203.              standard MS-DOS floppies, set this value to 0.  
  204.  
  205.           LowCyl = 
  206.              The  physical  low  cylinder  number of the beginning the
  207.              the  device  partition.   To calculate the LowCyl use the
  208.              following formula:  
  209.               
  210.                LowCyl = [BLOCK_beg / (Surfaces * BlocksPerTrack)]
  211.                            (integer part only)
  212.                BLOCK_beg = The beginning block number of the partition
  213.  
  214.                Example =>  0 = [ 0 / (2 * 9)]
  215.                
  216.  
  217.              For  standard  40  or  80  track  floppy drives, set this
  218.              value to 0.  
  219.  
  220.           HighCyl =
  221.              The  physical  high  cylinder  number  of the end the the
  222.              device  partition.   To  calculate  the  HighCyl  use the
  223.              following formula:  
  224.               
  225.                HighCyl = [BLOCK_end / (Surfaces * BlocksPerTrack)]
  226.                            (integer part only)
  227.                BLOCK_end = The end block number of the partition
  228.  
  229.                Example =>  79 = [ 1439 / (2 * 9)]
  230.                
  231.  
  232.              For  standard  80  track floppy drives, set this value to
  233.  
  234.  
  235.  
  236.           2-2
  237.                                    CrossDOS ... The MS-DOS File System
  238.  
  239.  
  240.              79.   For standard 40 track floppy drives, set this value
  241.              to  39.   For  standard  80  track  floppy drives used in
  242.              Double Track Step Mode, set this value to 39.  
  243.  
  244.           FileSystem = 
  245.              The  name of the FileSystem code file to be used to allow
  246.              AmigaDOS  to  access  non-AmigaDOS  formatted disks.  For
  247.              this product, use "L:MSDOSFileSystem".  
  248.  
  249.           Stacksize =
  250.              The  stack  size  needed  for  the file system task.  Use
  251.              4000 bytes or more if desired.  
  252.  
  253.           Priority = 
  254.              The  priority  of  the  file  system  task.  Should be at
  255.              least a priority 5.  Modify if desired.  
  256.  
  257.           GlobVec = 
  258.              The  global  vector  of the file system task.  This value
  259.              MUST be set to -1.  
  260.  
  261.           Buffers = 
  262.              The  number  of  cache  buffers for the file system task.
  263.              Set  to the number of buffers to you desire.  Each buffer
  264.              consumes  about 1040 bytes.  The more buffers, the faster
  265.              the  performance.   Be  aware though, there is a point of
  266.              diminishing returns with more buffers.  
  267.  
  268.              For  normal  sized  directories  a  value of 5 buffers is
  269.              sufficient.    If   large   and/or   multiple  levels  of
  270.              directories  are used (ie. greater than 2), a value of 10
  271.              will   yield   faster  accesses.   The  AmigaDOS  command
  272.              "addbuffers"  will  add  more  buffers to the file system
  273.              cache.  
  274.  
  275.           BufMemType = 
  276.              The  type  of  memory  used  by the cache buffers.  It is
  277.              recommended   to  set  this  value  to  0  or  1  (PUBLIC
  278.              memory).  
  279.  
  280.           Mount = 
  281.              If  this  parameter is positive (>0), the "mount" command
  282.              will   immediately   install   the   file   system  code.
  283.              Otherwise,  the file system will be loaded when the first
  284.              access  to  the  device occurs.  It is recommended to set
  285.              this  value  to 0 or do not include this parameter at all
  286.              so  that  the  memory for the file system and device will
  287.              not be used until needed.  
  288.  
  289.           DosType = 
  290.              This  parameter  indicates  the type of file system used.
  291.              For    floppy    drives,    this    value    should    be
  292.  
  293.  
  294.  
  295.                                                                    2-3
  296.           CrossDOS ... The MS-DOS File System
  297.  
  298.  
  299.              0x4D534400.   For  80  track  5 1/4" drives used in
  300.              the  40 track (double track step) mode, this value should
  301.              be  0x4D444400  (Refer  to section "Double Track
  302.              Step Mode" for further explanation).
  303.  
  304.           # 
  305.              Device  mountlist  terminating character.  This character
  306.              MUST  be present in the first column of new line
  307.              to  terminate  the  mountlist  parameters  for a specific
  308.              device.  
  309.  
  310.                NOTE 
  311.                Parameters  left out of the mountlist for a device, are
  312.                either automatically set to 0 or a default value.  
  313.  
  314.                NOTE 
  315.                Only  one  MS-DOS  File System is allowed to be mounted
  316.                on any one physical device.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.           2-4
  355.                                    CrossDOS ... The MS-DOS File System
  356.  
  357.  
  358.           w3    GLOSSARY        w 
  359.  
  360.           The  following  are  a  small glossary of terms used in this
  361.           manual.  
  362.  
  363.           CLI   -   Command   Line  Interpreter.   A  method  of
  364.           accessing  Amiga  programs  without  using the mouse.  It is
  365.           very flexible means of controlling the Amiga.  
  366.  
  367.           double-click  -  The  action  of  quickly pressing and
  368.           releasing a mouse button (usually the left one) twice.  
  369.  
  370.           extend-select  - The method of selecting more than one
  371.           icon.   In  order  to  use  it, hold down the SHIFT key when
  372.           selecting  and  icon.   When selecting multiple files, order
  373.           of selection is important.
  374.  
  375.           MountList  File  -  This  is a standard text file that
  376.           describes  new  devices  for  the  Amiga operating system to
  377.           use.   Each  device  has its own set of MountList parameters
  378.           that follow its designated name in the file.  
  379.  
  380.           Project  Icon  -  This  is a special icon that calls a
  381.           program  specified  in  the  DEFAULT TOOL parameter and will
  382.           pass  options  listed  in  the  TOOL TYPES parameters of the
  383.           icon file.  
  384.  
  385.           select  -  The  action  of  pressing and releasing the
  386.           left mouse button over the object to be selected.  
  387.  
  388.           TOOL  TYPES  parameters  -  These parameters are found
  389.           (and    can   be   modified)   from   WORKBENCH   when   the
  390.           "Project/Info"  menu  item is selected for the icon you wish
  391.           to view/modify.
  392.  
  393.           WORKBENCH   -   The   standard  Amiga  graphical  user
  394.           interface  that  uses  icons  to  access  programs  and data
  395.           files.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                                                    3-1
  414.                                    CrossDOS ... The MS-DOS File System
  415.  
  416.  
  417.           w4    DEVICE ERROR CODES      w 
  418.  
  419.           The  following  is  a list of most of the device error codes
  420.           supported.  
  421.  
  422.           Err#    Error Name          Description
  423.           ----------------------------------------------------------------
  424.           -1    IOERR_OPENFAIL        device/unit failed to open  
  425.           -2    IOERR_ABORTED         request aborted
  426.           -3    IOERR_NOCMD           command not supported
  427.           -4    IOERR_BADLENGTH       not a valid length
  428.  
  429.           20    TDERR_NotSpecified    general catchall
  430.           21    TDERR_NoSecHdr        couldn't find any sectors on track
  431.           22    TDERR_BadSecPreamble  bad sector header
  432.           23    TDERR_BadSecID        bad sector header
  433.           24    TDERR_BadHdrSum       sector header had incorrect CRC
  434.           25    TDERR_BadSecSum       data had incorrect CRC
  435.           26    TDERR_TooFewSecs      couldn't find enough sectors
  436.           27    TDERR_BadSecHdr       bad sector header
  437.           28    TDERR_WriteProt       can't write to a protected disk
  438.           29    TDERR_DiskChanged     no disk in the drive
  439.           30    TDERR_SeekError       couldn't find track 0
  440.           31    TDERR_NoMem           ran out of memory
  441.           32    TDERR_BadUnitNum      asked for a unit > 3
  442.           33    TDERR_BadDriveType    not a recognized drive
  443.           34    TDERR_DriveInUse      someone else allocated the drive
  444.           35    TDERR_PostReset       user hit reset; awaiting doom
  445.           36    MDERR_OutofTracks     out of physical tracks
  446.           37    MDERR_InvParam        invalid parameter (MD_SETPARMS)
  447.           38    MDERR_IndexNotSync    index signal not available
  448.           39    MDERR_WrongTrack      drive head on wrong physical track
  449.  
  450.           4.1  "In Case of Difficulty"      
  451.  
  452.           Should  you  experience  some difficulty accessing an MS-DOS
  453.           disk,  here  are  some  ideas  that may help narrow down the
  454.           problem.  
  455.  
  456.           First,  make  sure you have configured the drive you wish to
  457.           use  the  MS-DOS  disk  on  by  using  either  the "MountMF"
  458.           command  or  the  "Attach"  command.   If  you are using the
  459.           "Attach"  command,  specify  the  correct device name of the
  460.           drive  you  wish to use.  The device names correspond to the
  461.           device  names  given  by  Commodore  (ie. DI0: is the MS-DOS
  462.           device name whereas DF0: is the AmigaDOS device name).
  463.  
  464.           The  easiest  way  check  an  MS-DOS  disk  is  to  run  the
  465.           "DiskChk"  program  included with CrossDOS to generate error
  466.           numbers that can be used with the following chart.  
  467.  
  468.           4.1.1  Problem/Solution Chart        
  469.  
  470.  
  471.  
  472.                                                                    4-1
  473.           CrossDOS ... The MS-DOS File System
  474.  
  475.  
  476.           Problem             Solution (or areas to check)
  477.           =============================================================
  478.           "Not a DOS Disk"    Make sure the disk is an MS-DOS standard
  479.            Requester          density formatted disk.  The disk may be
  480.                               an AmigaDOS or MS-DOS high density
  481.                               formatted disk.
  482.  
  483.           "Disk Ejected Too   Disk removed before all information
  484.            Soon" Requester    written to it. Replace disk and retry
  485.                               may recover without corruption.  We
  486.                               recommend you wait at least 3 seconds
  487.                               from the last disk access before removing
  488.                               the disk.
  489.  
  490.           "FAT Table Corrupt" Important information on the disk is
  491.            Requester          sensed to be corrupt.  Use a disk salvage
  492.                               program on your MS-DOS computer to try to
  493.                               recover data where possible.
  494.  
  495.           "Disk Full"         Exceeded the capacity of the system disk.
  496.            Requester using    Remove unnecessary files from the disk or
  497.            "Install_msdosFS"  use "Attach" command.
  498.  
  499.           "Not an MS-DOS      Device name selected does not refer to an
  500.            disk" response     MS-DOS configured device.  Chose the
  501.            from "MFormat"     device name such as DI0: instead of DF0:
  502.  
  503.           "DF0:BAD" disk      This is OK.  The task that handles the
  504.            icon               device called DF0: cannot recognize a
  505.                               foreign disk format.
  506.  
  507.           Used "MountMF"      "MountMF" only configures all the drives
  508.            from WORKBENCH or  as MS-DOS devices but does not load the
  509.            boot file          file system code to save memory.  Your
  510.            but no icon        first access of the device in a program
  511.            appears            will load the file system and the icon
  512.                               should appear.
  513.  
  514.           Copied icon to      Copy only files with NO file extension.
  515.            MS-DOS disk using  WORKBENCH icons already have an extension
  516.            WORKBENCH but      (.info).  MS-DOS file names can only have
  517.            cannot properly    one extension.  Also, avoid file names
  518.            access icon later  longer than 8 characters. Rename files if
  519.            on same disk       they are a problem. 
  520.  
  521.           Changed the MS-DOS  The 5 1/4" drive does not support the
  522.            disk on the 5 1/4" "diskchange" signal.  When you change
  523.            drive and still    disks, issue the CLI "DiskChange" command
  524.            get the old di-    or our "DiskChg" command on the drive
  525.            rectory from the   before your next access to the new disk. 
  526.            previous disk
  527.  
  528.  
  529.  
  530.  
  531.           4-2
  532.                                    CrossDOS ... The MS-DOS File System
  533.  
  534.  
  535.           Copied file to      Avoid using spaces in files names.  The
  536.            MS-DOS disk but    MS-DOS computer ignores everything after
  537.            cannot find it     the space character.
  538.            when reading the
  539.            disk on my MS-DOS
  540.            computer
  541.  
  542.           Error=-4            TDPatch12 or TDPatch13 needs to be applied.
  543.  
  544.           Error=21            Could not find any sectors on the
  545.                               specified track.  Probably not MS-DOS
  546.                               standard density formatted.
  547.  
  548.           Error=22            Sector not aligned with index signal
  549.                               from disk.  Usually not disastrous.
  550.                               Retry may recover.
  551.  
  552.           Error=23            Sector not found.  Disk may be corrupt.
  553.                               Retry may recover.
  554.  
  555.           Error=24            Sector identification info corrupt.
  556.                               Retry may recover.
  557.  
  558.           Error=25            Sector data may be corrupt.
  559.                               Retry may recover.
  560.  
  561.           Error=38            Index signal from the drive not received.
  562.                               Amiga needs service to correct hardware
  563.                               problem.
  564.           ==============================================================
  565.  
  566.           If you still have problems, you can call us at:
  567.           (313) 459-7271
  568.             Mon-Fri   10:00 AM to 5:00 PM     Eastern Standard Time
  569.  
  570.  
  571.           4.1.2  Helpful Tips        
  572.  
  573.           Here  are some helpful tips to make using CrossDOS as simple
  574.           as possible.  
  575.  
  576.           -  Avoid file names longer than 8 characters.  
  577.           -  Avoid file extensions longer than 3 characters.  
  578.           -  Avoid space in file names or file extensions.  
  579.           -  When  using WORKBENCH, avoid transferring files with file
  580.              extensions.  Rename them first if necessary.  
  581.           -  Make  sure  the type of file you want to use between both
  582.              the   Amiga   program   and   the   MS-DOS   program  are
  583.              compatible.   Example:  A  Scribble! file is not readable
  584.              by a WordPerfect wordprocessor.
  585.           -  Should you exhibit read or write  errors with no specific
  586.              pattern, we suggest  you clean the  floppy drive heads of
  587.              both the Amiga and MS-DOS computers.
  588.  
  589.  
  590.                                                                    4-3
  591.                                    CrossDOS ... The MS-DOS File System
  592.  
  593.  
  594.              w5    CrossDOS UTILITIES       w 
  595.  
  596.           The  following  is a description of utilities to enhance the
  597.           usage of CrossDOS.  
  598.  
  599.           5.1  MS-DOS File System Support Utilities     
  600.  
  601.           The  following  utilities  are included with this product to
  602.           enhance  your usage of CrossDOS.  These utilities can be run
  603.           from the CLI or from WORKBENCH.
  604.  
  605.           5.2  "MountMF"        
  606.  
  607.           Format:   MountMF [devicename_prefix]
  608.           Template: MountMF "DEVICENAME_PREFIX/A" 
  609.           Purpose:  To "mount" all MS-DOS floppy devices.
  610.           Path:     MSDOS_FileSystem:MountMF
  611.           Specification:
  612.  
  613.           This  utility  attempts to "mount" all MS-DOS floppy devices
  614.           connected  to  the Amiga.  This utility can be executed from
  615.           WORKBENCH,  the  CLI or your startup-sequence.  Placing this
  616.           command    before    the    "LoadWB"    command    in   your
  617.           startup-sequence   seems  to  provide  the  most  convenient
  618.           results.  
  619.  
  620.           The  following is an example when using the command from the
  621.           CLI:
  622.            
  623.                MSDOS_FileSystem:MountMF
  624.                
  625.  
  626.           To  MountMF  a  device  from  WORKBENCH, double-click on the
  627.           MountMF icon.  
  628.  
  629.           The  DEVICENAME_PREFIX  option  is  available  as TOOL TYPES
  630.           parameter in the project icons.  
  631.  
  632.           MountMF   automatically  executes  the  TDPatch  command  if
  633.           needed.  
  634.  
  635.                NOTE 
  636.                If  your  system is using either Kickstart V1.2 or V1.3
  637.                ROMs,  you  MUST make sure that the appropriate TDPatch
  638.                (TDPatch12  or  TDPatch13)  is  installed  in  your  C:
  639.                directory for this command to work.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.                                                                    5-1
  650.           CrossDOS ... The MS-DOS File System
  651.  
  652.  
  653.           5.2.1  "Mount_JDS"         
  654.  
  655.           Format:   Mount_JDS <devicename> [FROM <file>]
  656.           Template: Mount_JDS "DEVICENAME/A,FROM/K"
  657.           Purpose:  To create an AmigaDOS device node.
  658.           Path:     C:Mount_JDS
  659.           Specification:
  660.  
  661.           This  utility  attempts  to  create an AmigaDOS device node.
  662.           In   other  words,  Mount_JDS  informs  the  Amiga  that  an
  663.           additional  device  has  been added to the system.  When the
  664.           Mount_JDS   command   is  issued,  Mount_JDS  looks  in  the
  665.           DEVS:MountList  file  (or  the  optional  FROM file) for the
  666.           parameters  of  the  device  that  is  being  mounted.  This
  667.           utility  is  only  needed  if you do not already have a V1.3
  668.           compatible "mount" command.  
  669.  
  670.           The  following is an example when using the command from the
  671.           CLI: 
  672.            
  673.                Mount_JDS DI0: FROM DEVS:mountlist.msdosFS
  674.                
  675.  
  676.           To  mount  a  device  from  WORKBENCH,  double-click  on the
  677.           Mount_JDS.<device> icon (such as "Mount_JDS.DI0").  
  678.  
  679.           The  FROM,  and  DEVICENAME  options  are  available as TOOL
  680.           TYPES  parameters  in  the  project  icons.   Refer  to  the
  681.           project  icons  supplied with this product for the format of
  682.           these parameters.  
  683.  
  684.  
  685.           5.2.2  "Kill"         
  686.  
  687.           Format:   Kill <devicename>
  688.           Template: Kill "DEVICENAME"
  689.           Purpose:  To remove a file system and free resources
  690.           Path:     C:Kill
  691.           Specification:
  692.  
  693.           This  utility  attempts  to Kill the MS-DOS File System that
  694.           is  loaded.   It  will  try  to return all the resources and
  695.           memory allocated.  
  696.  
  697.           The  following is an example when using the command from the
  698.           CLI: 
  699.            
  700.                Kill DI0:
  701.                
  702.  
  703.           To    execute    from   WORKBENCH,   double-click   on   the
  704.           Kill.<device>  icon  (such  as  Kill.DI0) or double-click on
  705.  
  706.  
  707.  
  708.           5-2
  709.                                    CrossDOS ... The MS-DOS File System
  710.  
  711.  
  712.           the  Kill  icon and the program will prompt you to enter the
  713.           name of the device to Kill.  
  714.  
  715.           Caution  must  be  exercised  in using this command since it
  716.           does  not check to make sure all the file locks are returned
  717.           to  the  file system before Killing it.  If file locks still
  718.           exist  after  Killing  the  file system, any use of the lock
  719.           may crash the system.  
  720.  
  721.           Using  this  utility  when  WORKBENCH  is running may "hang"
  722.           WORKBENCH.   To  recover  from  a  hung  WORKBENCH,  issue a
  723.           "LoadWB" command from a CLI again.  
  724.  
  725.           Kill  may  work  with  other  file  systems  but  we  do not
  726.           guarantee the results.  
  727.  
  728.  
  729.           5.2.3  "DiskChk"        
  730.  
  731.           Format:   DiskChk <devicename>
  732.           Template: DiskChk "DEVICENAME"
  733.           Purpose:  To check the read integrity of any disk
  734.           Path:     SYS:System/DiskChk
  735.           Specification:
  736.  
  737.           This  utility  attempts  to  check  the read validity of any
  738.           disk and report any errors.  
  739.  
  740.           The  following is an example when using the command from the
  741.           CLI: 
  742.            
  743.                DiskChk DI0:
  744.                
  745.  
  746.           It  will interactively ask which blocks to check ( lower and
  747.           upper  limits).   If  the  character  "r" is place after the
  748.           upper   limit  value  entered,  DiskChk  will  "repeat"  the
  749.           checking until a Control-C is typed.  
  750.  
  751.           This   utility  was  originally  designed  to  check  MS-DOS
  752.           formatted  disks  but  it should work on any disk mounted on
  753.           the Amiga.  
  754.  
  755.           To  check  disks  from  WORKBENCH, select the desired MS-DOS
  756.           disk  icon  then  (with  shift key held) double-click on the
  757.           DiskChk icon.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.                                                                    5-3
  768.           CrossDOS ... The MS-DOS File System
  769.  
  770.  
  771.           5.2.4  "MFormat"         
  772.  
  773.           Format:   MFormat DRIVE <devicename> NAME <diskname> [QUICK]
  774.                            [NOVERIFY] [FAST] [FMT=MQD9|MD9|MS9|AD9|AS9]
  775.           Template: MFormat "DEVICENAME,DISKNAME,QUICK/S,NOVERIFY/S,
  776.                            FMT/K"
  777.           Purpose:  Format a disk using an MS-DOS format
  778.           Path:     SYS:System/MFormat
  779.           Specification:
  780.  
  781.           This  utility will format a disk an MS-DOS format using some
  782.           of  the  parameters  in  the  mountlist  or an explicit disk
  783.           format (FMT=).  
  784.  
  785.           The  QUICK  option  will  only  reformat an MS-DOS disk that
  786.           previously  had  the same format.  It will supply a new boot
  787.           block,  file  allocation  tables and the root directory with
  788.           the volume name as the only entry.  
  789.  
  790.           The   NOVERIFY  option  will  not  perform  a  verify  after
  791.           formatting  a  cylinder.   Using  this option will perform a
  792.           quicker  physical  format of the disk but the resulting disk
  793.           is  not  checked for errors.  The QUICK option overrides the
  794.           NOVERIFY option.  
  795.  
  796.           The  FAST  option  is  faster  than  the NOVERIFY option and
  797.           consequently  checks even less of the format integrity.  The
  798.           QUICK option overrides the FAST option.
  799.  
  800.           The  FMT  option allows another format to be used instead of
  801.           the   default   format  resulting  from  parameters  in  the
  802.           mountlist  for the device.  Only one format specification is
  803.           allowed after the FMT keyword.  
  804.  
  805.           The  following is an example when using the command from the
  806.           CLI: 
  807.            
  808.                MFormat DRIVE DI0: NAME "MSDOS_DISK" NOVERIFY FMT=MQD9
  809.                
  810.  
  811.           The  following  table  lists the important parameters of the
  812.           supported disk formats.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.           5-4
  827.                                    CrossDOS ... The MS-DOS File System
  828.  
  829.  
  830.           Format| Format| *Num | Num | Secs | Bytes | **Max | Drive
  831.            Name |  Type | Trks |Sides| /Trk | /Disk |  RDE  | Type
  832.           ------+-------+------+-----+------+-------+-------+------
  833.            MQD9 | MSDOS |  80  |  2  |   9  |  720K |  112  | 3 1/2
  834.            MD9  | MSDOS |  40  |  2  |   9  |  360K |  112  | 5 1/4
  835.            MS9  | MSDOS |  40  |  1  |   9  |  180K |   64  | 5 1/4
  836.            AD9  | ATARI |  80  |  2  |   9  |  720K |  112  | 3 1/2
  837.            AS9  | ATARI |  80  |  1  |   9  |  360K |  112  | 3 1/2
  838.  
  839.           *  80 track formats not allowed on 40 track, 5 1/4" drives.
  840.           ** RDE = root directory entries. One root directory entry
  841.               is used for the volume name.
  842.  
  843.           To  format a default disk from WORKBENCH, select the desired
  844.           MS-DOS  disk icon then (with shift key held) double-click on
  845.           the  MFormat  icon.   If  no  MS-DOS disk icon is available,
  846.           just  double-click on the MFormat icon.  It will then prompt
  847.           you for the name of the mounted MS-DOS device to format.  
  848.  
  849.           If  you wish to specify a format other than the default from
  850.           WORKBENCH,    select  the  desired  MS-DOS  disk  icon  then
  851.           double-click  on  the  project  icon with the desired format
  852.           type (such as "MSDOS_D9.MFormat").  
  853.  
  854.           The  FMT,  QUICK, FAST and NOVERIFY options are available as
  855.           TOOL TYPES parameters in the project icons.  
  856.  
  857.  
  858.           5.2.5  "MDiskCopy"         
  859.  
  860.           Format:   MDiskCopy [FROM] <SRCdsk> TO <DSTdsk>
  861.           Template: MDiskCopy "SRCDISK,DSTDISK"
  862.           Purpose:  Make a copy of an MS-DOS disk
  863.           Path:     SYS:System/MDiskCopy
  864.           Specification:
  865.  
  866.           This  utility  will make a copy of an MS-DOS disk on another
  867.           mounted   MS-DOS   drive.    MDiskCopy   will   not  perform
  868.           single-drive copies.  
  869.  
  870.           The  following is an example when using the command from the
  871.           CLI:
  872.            
  873.                MDiskCopy DI0: TO DI1:
  874.                
  875.  
  876.           To  copy  disks  from  WORKBENCH,  select the desired source
  877.           MS-DOS  disk icon first, extend-select (with shift key held)
  878.           the  destination MS-DOS disk icon next, then (with shift key
  879.           still held) double-click on the MDiskCopy icon.  
  880.  
  881.           If   the   MS-DOS   disk   icons  are  not  displayed,  just
  882.  
  883.  
  884.  
  885.                                                                    5-5
  886.           CrossDOS ... The MS-DOS File System
  887.  
  888.  
  889.           double-click  on  the  MDiskCopy  icon  and the program will
  890.           prompt  you  for  the names of the mounted MS-DOS devices to
  891.           copy.  
  892.  
  893.  
  894.           5.2.6  "Attach"         
  895.  
  896.           Format:   Attach <devicename>
  897.           Template: Attach "DEVICENAME/A" 
  898.           Purpose:  To "mount" and "load" an MS-DOS device.
  899.           Path:     MSDOS_FileSystem:Attach
  900.           Specification:
  901.  
  902.           This  utility  attempts  to  "mount"  and  "load"  an MS-DOS
  903.           device.   This  utility will only work with the installation
  904.           disk supplied (see NOTE).
  905.  
  906.           The  following is an example when using the command from the
  907.           CLI: 
  908.            
  909.                MSDOS_FileSystem:Attach DI0:
  910.                
  911.  
  912.           To  Attach  a  device  from  WORKBENCH,  double-click on the
  913.           Attach.<device>  icon (such as "Attach.DI0") or double-click
  914.           on  the  Attach icon and the program will prompt you for the
  915.           name of the mounted MS-DOS device.  
  916.  
  917.           The  DEVICENAME  option is available as TOOL TYPES parameter
  918.           in the project icons.  
  919.  
  920.           Attach   automatically   executes  the  TDPatch  command  if
  921.           needed.  
  922.  
  923.                NOTE 
  924.                Please   use  a  copy  of  the  original  product  disk
  925.                supplied.   You  can  add files to it but do not modify
  926.                any of the files currently on the disk.  
  927.  
  928.  
  929.           5.2.7  "TxFilter"         
  930.  
  931.           Format:   TxFilter <devicename> [ON|OFF]
  932.           Template: TxFilter "DEVICENAME/A,ON/S,OFF/S" 
  933.           Purpose:  To apply a CTRL-M and CTRL-Z filter on all files
  934.                          transferred to and from the specified device.
  935.           Path:     SYS:System/TxFilter
  936.           Specification:
  937.  
  938.           This  utility  attempts  to apply a CTRL-M and CTRL-Z filter
  939.           on  ALL  files transferred to and from the specified device.
  940.           This  utility  is  equivalent  to  using the  "CTRL-M/CTRL-Z
  941.  
  942.  
  943.  
  944.           5-6
  945.                                    CrossDOS ... The MS-DOS File System
  946.  
  947.  
  948.           Filter" character ']' within all MS-DOS filenames.  
  949.  
  950.           The  program  opens  a  window  with  a  small button gadget
  951.           indicating  the  current  status  of the text filter for the
  952.           device.   To  toggle  the  filter  into  the opposite state,
  953.           select   button  gadget.   To  completely  remove  the  text
  954.           filter,  select the close gadget in the upper left corner of
  955.           the window.  
  956.  
  957.           The  following is an example when using the command from the
  958.           CLI: 
  959.           
  960.                TxFilter DI0:
  961.                
  962.  
  963.           If  the option of ON or OFF is not specified, the default is
  964.           OFF.  
  965.  
  966.           To  TxFilter  a  device  from WORKBENCH, double-click on the
  967.           TxFilter.<device>   icon   (such   as   "TxFilter.DI0")   or
  968.           double-click  on  the  TxFilter  icon  and  the program will
  969.           prompt you for the name of the mounted MS-DOS device.  
  970.  
  971.           The  DEVICENAME  option is available as TOOL TYPES parameter
  972.           in the project icons.  
  973.  
  974.  
  975.           5.2.8  "IntlTrans"        
  976.  
  977.           Format:   IntlTrans <devicename> [ON|OFF]
  978.           Template: IntlTrans "DEVICENAME/A,ON/S,OFF/S" 
  979.           Purpose:  To apply an International translation on all files
  980.                          transferred to and from the specified device.
  981.           Path:     SYS:System/IntlTrans
  982.           Specification:
  983.  
  984.           This  utility attempts to apply an International translation
  985.           on  ALL  files transferred to and from the specified device.
  986.           This  utility  is  equivalent  to  using the  "International
  987.           Translator"   character   '['  (formerly   the   "High   Bit
  988.           Filter")  within  all  MS-DOS filenames.  This function will
  989.           ONLY  work when the International version of the file system
  990.           "MSDOSFileSystem.INTL" is used.  
  991.  
  992.           The  program  opens  a  window  with  a  small button gadget
  993.           indicating  the  current  status  of  the translator for the
  994.           device.   To  toggle the translator into the opposite state,
  995.           select  button gadget.  To completely remove the translator,
  996.           select  the  close  gadget  in  the upper left corner of the
  997.           window.  
  998.  
  999.           The  following is an example when using the command from the
  1000.  
  1001.  
  1002.  
  1003.                                                                    5-7
  1004.           CrossDOS ... The MS-DOS File System
  1005.  
  1006.  
  1007.           CLI: 
  1008.            
  1009.                IntlTrans DI0:
  1010.                
  1011.  
  1012.           If  the option of ON or OFF is not specified, the default is
  1013.           OFF.  
  1014.  
  1015.           To  IntlTrans  a  device from WORKBENCH, double-click on the
  1016.           IntlTrans  icon and the program will prompt you for the name
  1017.           of  the  mounted  MS-DOS  device.   You may use the TxFilter
  1018.           utility to do the same thing.  
  1019.  
  1020.  
  1021.           5.2.9  "DiskChg"         
  1022.  
  1023.           Format:   DiskChg <devicename>
  1024.           Template: DiskChg "DEVICENAME/A" 
  1025.           Purpose:  To force a "diskchange" on the specified device.
  1026.           Path:     SYS:System/DiskChg
  1027.           Specification:
  1028.  
  1029.           This   utility   forces  a  "diskchange"  on  the  specified
  1030.           device.   This command is useful for forcing a diskchange on
  1031.           5  1/4"  floppy drives because they do not have the hardware
  1032.           to  support automatic diskchanges.  This command can also be
  1033.           used on any disk device including hard drives.  
  1034.  
  1035.           The  following is an example when using the command from the
  1036.           CLI: 
  1037.            
  1038.                DiskChg DI0:
  1039.                
  1040.  
  1041.           To  DiskChg  a  device  from  WORKBENCH, double-click on the
  1042.           DiskChg.<device>    icon    (such   as   "DiskChg.DI0")   or
  1043.           double-click  on  the  DiskChg  icon  and  the  program will
  1044.           prompt you for the name of the mounted MS-DOS device.  
  1045.  
  1046.           The  DEVICENAME  option is available as TOOL TYPES parameter
  1047.           in the project icons.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.           5-8
  1063.                                    CrossDOS ... The MS-DOS File System
  1064.  
  1065.  
  1066.           5.2.10  "TDPatch12 or TDPatch13"       
  1067.  
  1068.           Format:   TDPatch12 or TDPatch13
  1069.           Template: TDPatch12 or TDPatch13
  1070.           Purpose:  Patch the trackdisk.device for V1.2 or V1.3 ROMs
  1071.           Path:     C:TDPatch12 or TDPatch13
  1072.           Specification:
  1073.  
  1074.           TDPatch12  or TDPatch13 will patch the trackdisk.device code
  1075.           for  Kickstart  ROMs  V1.2 or V1.3 respectively.  This patch
  1076.           is  needed  because  of  a couple bugs in the trackdisk code
  1077.           supplied   by   Commodore   that   are   not   patched  with
  1078.           "SetPatch".   The  patch  also  supplies  a  feature  in the
  1079.           trackdisk  code that is found in V2.0 Kickstart ROMs but not
  1080.           in  the eariler versions.  This feature is needed to provide
  1081.           CrossDOS with faster floppy data access.
  1082.  
  1083.           The  installation program will detect your Kickstart version
  1084.           and install the proper patch command to your system disk.  
  1085.  
  1086.           This   patch   will   be  automatically  executed  with  the
  1087.           "MountMF"  and  "Attach"  commands.   CrossDOS WILL NOT work
  1088.           with  floppies  if  this patch is not applied for users with
  1089.           V1.2 and V1.3 ROMs 
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                                                                    5-9
  1122.  
  1123.